home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
programs
/
mta_vf35.zip
/
MTMDOCEN.DOC
< prev
next >
Wrap
Text File
|
1993-02-22
|
27KB
|
586 lines
╔══════════════════════════════ ┌─────────────────┐
║ MTM Make Them Modified │ D.I.S.P. │────┐
║ │ │░░░░│
╟────────────────────────────── │ │░░░░│
║ (c) 1993 Robert W.van Hoeven │ Dutch │░░░░│
╟────────────────────────────── │ Independent │░░░░│
║ Release : 15.35 │ ShareWare │░░░░│
║ Rel.Date: February 22th, 1993 │ Programmer│░░░░│
╠══════════════════════════════ └─────────────────┘░░░░│
║ | │░░░░░░░░░░░░░░░░░│
║ │ MTM.EXE | └─────────────────┘
║ │ | ┌─────┐ |
║ │ | │░░░░░│ |
║ │ | └──┬──┘ |
║ │ Lines starting with '│' are | ┌────┴────┐ |
║ │ changes to release 15.30 ------││││││ ═══│-------
║ └─────────┘
╠═══════════════════════════════
║ Address: Robert W. van Hoeven
║ PO. Box 131
║ 1170 AC Badhoevedorp
║ Nederland / Holland
╚═══════════════════════════════
┌───────┬─────────────────────────────────────────────────────────────┐
│ 0 │ Table of contents │
└───────┴─────────────────────────────────────────────────────────────┘
1 ---- General information
1.1 Copyrights and License Agreement
1.2 Newer versions and contacting the author
2 ---- Package description and requirements
2.1 Preface
2.2 Requirements
2.3 History
2.4 Introduction & specs
3 ---- Installation description
3.1 Installation
3.2 Remarks on archives
3.3 MTA/MTM.CTL
3.4 MTM touching
3.5 Aborting MTM
4 ---- Runtime information
4.1 Running MTM
4.2 Examples
4.3 (De)compressors
4.4 Encryption and Authenticity
5 ---- Version information and credits
5.1 The BETA-team
5.2 Credits
5.3 Version history
5.4 Copyright, Trademarks
┌───────┬─────────────────────────────────────────────────────────────┐
│ 1 │ General information │
└───────┴─────────────────────────────────────────────────────────────┘
1.1 Copyrights and License Agreement
────────────────────────────────────
- Users of the MTA-package must accept this disclaimer of warranty:
- The MTA-package is supplied as is. The author disclaims all
warranties, expressed or implied, including, without limitation, the
warranties of merchantability and of fitness for any purpose. The
author assumes no liability for damages, direct or consequential,
which may result from the use of the MTA-package;
- The MTA-package is a "shareware program" and is provided at no
charge to the user for evaluation. Feel free to share it with your
friends, but please do not give it away altered or as part of
another system. The essence of "user-supported" software is to
provide personal computer users with quality software without high
prices, and yet to provide incentive for programmers to continue to
develop new products.
- If you find this program useful and find that you are using and
continue the use of the MTA-package after a 30 days trial period,
you must register the MTA-package as described below;
- Non-commercial can get a license for the usage up to this release of
the MTA-package for a small amount of money. Look into the details
in REGISTER.MTA. Previous registered users will receive a big
reduction to upgrade to the newer versions. These users should look
into the details in UPGRADE.MTA. For Non-commercial users there is
a POSSIBILITY to submit to one of the special contracts as explained
in the file REGISTER.MTA.
- Commercial usage of MTA will cost somewhat more. Also, a so called
'closed' Bulletin Board System (a system where the user must pay
direct to the SysOp to get full access) is has to pay more than a
Non-commercial user. Both types of users should look into the
details in REGISTER.MTA;
- The registration of the MTA-package will license ONE copy for use on
any computer at any one time, as long as the usage confirms to the
type of registration you have done (so NON-commercial usage when you
have a non-commercial license);
- Anyone distributing the MTA-package for any kind of remuneration
must first contact the Author at the address above for
authorization.
- You are encouraged to pass a copy of the MTA-package along to
your friends for evaluation. Please encourage them to register
their copy if they find that they can use it;
- Support on MTA, when used in a non-commercial environment, is
available by means of written letters or by entering the inter-
national echomail area DISP;
- Problems and suggestions can be entered in the FidoNet <tm> Echomail
conference <tm> called DISP (international). Entering this echo does
not exclude you of the duty to register the MTA-package, though
users who evaluate the product can enter the echo for questions;
- The MTA-package, all programs, the documentation and support-files
is copyrighted 1990,93 by Robert W. van Hoeven, PO. Box 131,
Badhoevedorp 1170AC, Holland. All rights are reserved. You may copy
this package for backup purposes. Also you may copy and share
unmodified copies of the whole package, providing that the copyright
notice is reproduced and included on all copies.
Excluded from this statement are the support-files written by other
authors. Please refer to the documentation of these programs for
copyrights and license agreements;
- It is forbidden to modify, adapt, translate, reverse engineer,
decompile and/or disassemble the software in the MTA-package.
Patching the medium at places that carry the software is seen as a
program change and is also forbidden. It is forbidden to create a so
called 'bypass' to skip the original introduction screens and delay.
Also it is forbidden to use such a 'bypass' unless supplied by the
author (Robert W. van Hoeven) himself;
- Performing any of the illegal actions as stated in the previous
lines, is a theft and no fair play to the author and, more
important, to the registered users;
- Bulletin Board Systems that distribute the MTA package can convert
the WHOLE package to any archive-system they like but all original
files must be included in the new archive. The MTA-package on the
Bulletin Board can contain at the most 2 extra files. These files
can only be a commercial for that Bulletin Board and/or validation
data that is presented as a service to all users and shall have no
other functions;
- After the normal trial period of 30 days, you must register the
soft- ware (see REGISTER.MTA) or you must remove it from your PC;
- Comments, suggestions and bug reports are welcome and will be
answered as soon I have the time to do so. You can send me a letter
of leave a NetMail <tm> message named to Rob Van.hoeven (mind the
point) on node 2:512/100 (RA Support, Monster, Holland, SysOp is
Reinier de Groot). When you want to send me normal mail, address it
to: Robert W. van Hoeven, PO. Box 131, 1171 AC Badhoevedorp,
Holland; Also you can enter messages in the FidoNet <tm> DISP
Echomail <tm> area;
1.2 Newer versions and contacting the author
───────────────────────────────────────────────────────────────────────
The newest version of MTA is always available at the DISP-HQ on node
2:512/100. MTA is also distributed thru a number of DISP support
nodes. There are three ways of obtaining newer versions of MTA:
- Logging on at DISP-HQ or a support node
Look into the file SUPPORT.MTA for a full list of support nodes;
- Logging on to a SDS node
MTA is distributed thru SDS/SDN, but only big minors (x.10, x.20 and
so on) and majors (14.01, 15.01 and so on) are submitted to the SDS
distribution point in Holland;
- Logging on to your own BBS;
Chances are, that you will find an older version (international
users) because it will take some time for the new version to 'bleed'
thru the net;
- Update service;
You can enter a special update service (read REGISTER.MTA).
If you think you have found problems in MTA, or in any other case, you
wish to contact the author, you can send me:
- A letter to the address you can find in the header of this file;
- A NetMail <tm> message to Rob Van.hoeven (please mind the point
between Van and Hoeven) at 2:512/100 or (better) 2:512/100.5;
- A Message in the FidoNet <tm> DISP echomail <tm> area;
┌───────┬─────────────────────────────────────────────────────────────┐
│ 2 │ Package description and requirements │
└───────┴─────────────────────────────────────────────────────────────┘
2.1 Preface
───────────────────────────────────────────────────────────────────────
MTM is an add-on utility for MTA and is distributed in the same
release archive that contains MTA. This program may) NOT be
distributed as a stand-alone package.
2.2 Requirements
───────────────────────────────────────────────────────────────────────
MTM requires: - PC XT/AT/386
- At least 320K free memory
- DOS 3.xx (4.xx not tested)
(also tested under 4Dos);
- HDU optional
2.3 History
───────────────────────────────────────────────────────────────────────
MTM is a little (grin) 'quick and dirty' supplement to the 'good old'
MTA program. This program is just for fun, but there are some BBS's
who would now 'kiss dutch ground'.
MTM is a simple archive manipulation program for BBS SysOp's. It can
do the following:
- Delete specific files from all archives (independent of the archive
format);
- Add specific files to all archives (independent of the archive
format);
- Remove headers from archives;
- Add headers to archives;
- Add and remove MTA mark-strings to archives without repacking;
- Touch archives in the same way as MTA does;
Why should you want to use these options you ask. If you are in the
habit of changing your headers and included files from time to time,
this program is a simple way of doing all that work for you.
The general scenario for using this program is:
- You have tons of files, piled up in all your directories and you
have included in any of these archives a file called U_READ.ME;
- Now you want to change all the included files;
- Also you would like to create an even bigger header, because your
users are not reaching their 'Leech limit' fast enough;
- Without MTM, you are gonna be busy for a long time but with MTM it
is easy;
This scenario could also be played with MTA, but MTA wants (it is
written for this function) to unpack and pack all your compressed
files and will take up to 100^3 times the time MTM will take for this
functions.
┌───────┬─────────────────────────────────────────────────────────────┐
│ 3 │ Installation description │
└───────┴─────────────────────────────────────────────────────────────┘
3.1 Installation
───────────────────────────────────────────────────────────────────────
See the documentation for MTA (MTADOCEN.DOC).
3.2 Remarks on archives
───────────────────────────────────────────────────────────────────────
MTM will only support normal compressed files. The extensions can
differ from the original extension (e.g. TEST.SDS can be TEST.PAK but
renamed). Abnormal compressed files are Self Extraction files (SFX).
These will be ignored by MTM.
3.3 MTA/MTM.CTL
───────────────────────────────────────────────────────────────────────
MTM will use some of the MTA options. In general all special options
in MTA (exits, CRC, Virus, includes and so on) are not used but all
XXXPath option are used. Also ZIPVersion and PAKVersion will be used.
The same goes for AutoDescription, IncludeFile and ExcludeFile. See
the MTADOCEN.DOC documentation for those statements that are used by
MTM.
3.4 MTM touching
───────────────────────────────────────────────────────────────────────
MTM will preserve the original file date/time. This is rather nice,
because users will not see these files as new-files after you have
converted them with MTM. There are options available to overrule this
default behavior.
3.5 Aborting MTM
───────────────────────────────────────────────────────────────────────
MTM will convert a complete directory (all compressed files). There is
only one way to abort MTM (in this release) and that is by means of
the three-finger salute.
┌───────┬─────────────────────────────────────────────────────────────┐
│ 4 │ Runtime Information │
└───────┴─────────────────────────────────────────────────────────────┘
4.1 Running MTM
───────────────────────────────────────────────────────────────────────
The calling syntax of MTM is:
MTM [filemask] {filemask]..{filemask} [options]
If no filemask is available, MTM will use '*.*' as the current
filemask. You can include up to 255 file-masks.
[options] are one or more (valid) command-line options. The following
options are available:
/DELMARK Delete any current MTA mark-string;
/ADDMARK Add the new MTA-markstring to the selected files;
/DELCOMMENT Delete any ZIP-comment from the selected ZIP-archives;
/ADDCOMMENT Add a new ZIP-comment to the selected ZIP-archives
(only if AutoDescription in MTA/MTM.CTL is
available);
/DELFILE Delete all files stated in the MTA/MTM.CTL
ExcludeFile option(s) from the selected archives;
/ADDFILE Add all files stated in the MTA/MTM.CTL IncludeFile
option(s) to the selected archives;
/TOUCHC{+days} Touch archive based on current date (/TOUCHC) or with
a date {+days} higher than the current date.
/TOUCHC+3 will touch the files with the current date
plus 3 days added;
/TOUCHL Touch archive based on lowest date inside archive;
/TOUCHH Touch archive based on highest date inside archive;
/TOUCHNEW[dat] Touch archive with date [dat]. [dat] has format
of mmddyy;
/DELAV Force MTM to delete files even if the source archive
is AV protected;
/W{path} Let MTM use {path}. If not supplied, MTM will use
the current directory. /W may not be used in
combination with /LVL0, /LVL1, /LVL2 or /LVL3;
/LVL0 This option is to keep compatibility with MTA. /LVL0
will force MTM to process all files in the CURRENT
directory. /LVL0 may not be used in combination with
/LVL1, /LVL2, /LVL3 or /W;
/LVL1 This will force MTM to process files UNDER the
current directory but NOT including the current
directory itself. /LVL0 may not be used in
combination with /LVL0, /LVL2, /LVL3 or /W;
/LVL2 This will force MTM to process files UNDER the
current directory AND including the current directory
itself;
/LVL3 This will force MTM to process files in ALL the
directories on the current drive. /LVL0 may not be be
used in combination with /LVL0, /LVL2, /LVL3 or /W;
/NOSFX When this parameter is supplied, MTM will not look
for SFX files (EXE/COM). These files are skipped.
When there are no EXE/COM SFX-files present, this
parameter will also cause MTM to run somewhat faster
because extended testing of files is skipped;
/NOSE When this parameter is supplied, MTM will not look
for files with non-archive extensions. Only archive
extensions (including EXE and COM for SFX-files) are
looked at, unless /NOSFX is supplied, in which case
MTM won't look at COM/EXE files either;
/IOPpassword Supply a password for encrypted files;
/? Displays a short help-screen;
4.2 Examples
───────────────────────────────────────────────────────────────────────
- MTM *.ZIP *.PAK /DELCOMMENT /ADDMARK
Delete any comment from ZIP/PAK files and add a mark-string;
- MTM *.* /DELMARK /DELFILE /DELCOMMENT
Cleans every file (ZIP/ZOO/PAK and so on) for comments, special
files and mark-strings;
- MTM *.* /DELMARK /ADDMARK
This will delete ANY mark-string and add yours. If you select
/ADDMARK, MTM will assume /DELMARK by default;
- MEM *.* /TOUCHNEW010192
Touch all ARCHIVE files with date 01-01-92;
4.3 (De)compressors
───────────────────────────────────────────────────────────────────────
See MTADOCEN.DOC
4.4 Encryption and Authenticity
───────────────────────────────────────────────────────────────────────
MTM is capable in reworking encrypted files. In this case, all
supplied files must have the same password. You can supply the
password to MTM with the /IOP command-line option. MTM will use this
password on ALL files it will work on in this run.
MTM can handle PkWare's Authenticity Verification. If you try to
delete a AV'ed file (with /DELFILE) than MTM will ignore this request
and leaves the AV'ed file inside the archive.
For further details on AV and Encryption you must look into the
documentation of MTA (MTADOCEN.DOC).
┌───────┬─────────────────────────────────────────────────────────────┐
│ 5 │ Version information and credits │
└───────┴─────────────────────────────────────────────────────────────┘
5.1 The BETA-team
───────────────────────────────────────────────────────────────────────
See the file SUPPORT.MTA for a full list of beta-testers;
5.2 Credits
───────────────────────────────────────────────────────────────────────
See MTADOCEN.DOC
5.3 Version history
───────────────────────────────────────────────────────────────────────
┌───────┬─────────────────────────────────────────────────────────────┐
│ 15.01 │ Major release │
└───────┴─────────────────────────────────────────────────────────────┘
■ Added /TOUCHxxx options to touch archives based on the MTA
algorithm (low, high and current) and also with a specific date
(TOUCHNEW);
■ Fixed a problem with the addition of comments in ARJ files;
┌───────┬─────────────────────────────────────────────────────────────┐
│ 15.02 │ Version release │
└───────┴─────────────────────────────────────────────────────────────┘
■ Documentation did not include the special mark before the changes;
┌───────┬─────────────────────────────────────────────────────────────┐
│ 15.05 │ Minor Release │
└───────┴─────────────────────────────────────────────────────────────┘
■ MTM would include (and touch) some of its own internal files. This
is fixed;
■ MTM will now also include SFX-files (archives with extensions EXE
or COM) for most of the functions because the original archivers
(and no internal routines) are now used to update these SFX-file;
┌───────┬─────────────────────────────────────────────────────────────┐
│ 15.06 │ Minor Release │
└───────┴─────────────────────────────────────────────────────────────┘
■ Part of the header (copyrights) was trucated. Fixed;
┌───────┬─────────────────────────────────────────────────────────────┐
│ 15.07 │ Minor Release │
└───────┴─────────────────────────────────────────────────────────────┘
■ Files that are manipulated will get their ORIGINAL attributes as
they were at startup (so the ARCHIVE bit is NOT set);
┌───────┬────────────────────────────┐
│ 15.08 │ Bug (?) Release │
└───────┴────────────────────────────┘
■ Reports got in from users about MTM in a OS/2 2.0ß DOS box. MTM is
not able to find any file that the user wants to select. This nasty
problem *looks* like a problem with OS/2 2.0 because the normal DOS
(ALSO IBM PC-DOS 5.0) works fine and the problems involved have to
do with DOCUMENTED interrupts and NORMAL Turbo Pascal processing.
Thanks to some willin beta-testers I was able to track the problem
down. This release contains a work-around that even causes MTM to be
somewhat smaller and still giving the same functions. Under OS/2 2.0
DOS boxes it *should* work again (as it did with beta-testers). Look
into HELP__ME.MTA for questions about OS/2 2.0ß because I don't run
this operating system and must rely on the input from users who do !
┌───────┬─────────────────────────────────────────────────────────────┐
│ 15.10 │ Version Release │
└───────┴─────────────────────────────────────────────────────────────┘
■ Only version number is changed;
┌───────┬─────────────────────────────────────────────────────────────┐
│ 15.20 │ Minor release │
└───────┴─────────────────────────────────────────────────────────────┘
■ Fixed a problem with the /DELFIL option. If you supplied masks in
the ExcludeFiles option everything would go OK, but if you used the
extended format (=MTA), files were not deleted. This if fixed;
■ Reworked the help-screen. Some information was missing;
■ Added coding to maintain SQZ files with MTM;
■ Changed /TOUCHCUR into /TOUCHC, /TOUCHNEW into /TOUCHN, /TOUCHHIG
into /TOUCHH and /TOUCHLOW into /TOUCHL to be more compatible with
the same command-line parameters in MTA;
■ Enhanced the /TOUCHC option to be compatible with MTA. You can now
add a number of days to the current-date;
■ Added /LVL0 (MTA-compatibility), /LVL1, /LVL2 and /LVL3 options to
let MTM work on more directories than just the current directory;
■ Added /NOSFX parameter to skip processing of SFX-files;
■ Added /NOSE parameter to skip processing of files with a
non-archive extension;
┌───────┬────────────────────────────┐
│ 15.21 │ Bug release │
└───────┴────────────────────────────┘
■ The MTM documentation still showed version 15.10 and not 15.20. This
is fixed;
■ Some new routines caused a number of cosmetic bugs. These are now
fixed (registered users!!!). Also registered users should unpack the
supplied MTA__REG.EXE (which contains MTAREG.EXE and MTAREG.DOC) and
run the MTAREG.EXE file once;
■ Added coding for SQZ 1.08.2 release;
■ Added coding to let the /ADDCOMMENT and /DELCOMMENT also work for
SQZ files;
┌───────┬─────────────────────────────────────────────────────────────┐
│ 15.30 │ Version Release │
└───────┴─────────────────────────────────────────────────────────────┘
■ Only version number is changed;
MTM is tested with PKWare PKPAK release 3.61, PKWare ZIP release 1.10,
PKWare ZIP release 1.93, NoGate PAK release 2.51, ARC release 6.02 and
ZOO release 2.10, DWC release 5.10, LHarc release 1.13c/d/213, LARC
release 3.33, ARJ version 2.39a, HYPER version 25 and SQZ version 1.082
5.4 Copyrights, Trademarks
───────────────────────────────────────────────────────────────────────
PKPAK, PKUNPAK, PKZIP and PKUNZIP are trademarks of PKWare Inc.
PAK is a trademark of NoGate Consulting.
SQZ is a trademark of Jonas I Hammarberg.
ARC is a trademark of SEA inc.
ZOO is a trademark of R. Dhesi.
DWC is a trademark of Dean W. Cooper
LZH and LHarc are trademarks of Yoshi;
LZS and LARC are trademarks of K.Miki H.Okumura and K.Masuyama
ARJ is a trademark of Robert K. Jung
HYPER is a trademark of Peter Sawatzki and Klaus Peter Nischke
4Dos is a trademark of Rex Conn and JP software
OS/2 is a trademark of International Business Machines (IBM)
PC-DOS is a trademark of International Business Machines (IBM)
MTM is written in Turbo Pascal 6.0, with help of the Turbo Debugger
2.5 and makes extensive use of Object Professional 1.14 and OPCFI V
16.02. Also a licensed commercial version of Strg 6.1 was used and
the TP 6.0 SYSTEM.TPU was replaced with a licensed commercial version
of SYS60a. Source editing is done with BRIEF 3.1;
Turbo Pascal is a trademark of Borland International
Turbo Debugger is a trademark of Borland International
Object Professional is a trademark of TurboPower Inc.
OPCFI is a trademark of Robert W. van Hoeven
SYS60 is a trademark of Eagle Performance Software
STRG61 is a trademark of Eagle Performance Software
BRIEF is a trademark of SolutionSystem
[=========================== END OF DOCUMENT ==========================]